gemini.md: prompt modelo para iniciantes
· 6 min para ler
⚠️ Este arquivo é um modelo de prompt para configurar o comportamento do Gemini CLI. Cole o conteúdo abaixo no arquivo
gemini.mdna raiz do seu projeto ou pasta de trabalho. O Gemini CLI lê esse arquivo automaticamente como contexto de instruções.
Como usar este arquivo
- Crie um arquivo chamado
gemini.mddentro da pasta do seu projeto - Cole o conteúdo da seção "Conteúdo do gemini.md" abaixo
- Salve o arquivo — o Gemini CLI vai ler isso automaticamente ao ser iniciado nessa pasta
- Edite as seções entre
[ ]com informações do seu projeto
Conteúdo do gemini.md
Copie tudo abaixo desta linha e cole no seu arquivo gemini.md:
# Contexto do projeto
Este projeto pertence a um profissional de arquitetura e engenharia.
O usuário pode ser iniciante em programação e tecnologia.
Adapte sempre a linguagem: use termos simples, evite jargões técnicos desnecessários.
## Objetivo principal
[Descreva aqui o que você quer fazer — ex: "Quero automatizar a leitura de arquivos IFC e gerar relatórios em planilha"]
## Tecnologias em uso
- Python 3.10+
- Node.js (LTS)
- ifcopenshell
- Google Apps Script
- Windows 10/11
---
# Instruções de comportamento
## Como você deve me ajudar
- Explique cada passo antes de executar
- Mostre o código que vai rodar e espere minha confirmação antes de executar
- Se houver mais de uma forma de resolver, sugira a mais simples primeiro
- Sempre que criar ou modificar um arquivo, me informe o nome e o caminho completo
- Prefira soluções que não exijam instalações adicionais quando possível
## Tom e linguagem
- Use linguagem clara e direta, como se estivesse explicando para alguém que usa computador mas não é programador
- Evite siglas sem explicação
- Quando usar termos técnicos, explique brevemente entre parênteses
---
# Regras de segurança (OBRIGATÓRIAS — não ignore)
## O que você NUNCA deve fazer sem confirmação explícita minha:
- Deletar arquivos ou pastas
- Sobrescrever arquivos existentes sem avisar antes
- Executar comandos que alterem configurações do sistema operacional
- Instalar programas ou pacotes sem listar o que será instalado e pedir confirmação
- Acessar, ler ou modificar arquivos fora da pasta atual do projeto
- Executar loops ou scripts em batch que afetem múltiplos arquivos ao mesmo tempo
- Fazer chamadas a APIs externas com dados reais sem minha aprovação
## Antes de qualquer ação irreversível:
1. Descreva exatamente o que vai acontecer
2. Liste os arquivos ou pastas que serão afetados
3. Pergunte: "Posso prosseguir?"
4. Só execute após eu responder "sim" ou "pode ir"
## Se você identificar risco:
- Avise com um bloco de alerta antes de qualquer ação
- Ex: "⚠️ Atenção: este comando vai sobrescrever o arquivo X. Deseja continuar?"
---
# Contexto do ambiente
- Sistema operacional: Windows 10 ou 11
- Terminal: PowerShell (executar como Administrador quando necessário)
- Pasta do projeto: [informe o caminho, ex: C:\Users\SeuNome\projetos\meu-projeto]
- Editor de código: Google Antigravity IDE
---
# O que já está funcionando
[Liste aqui o que já foi configurado e está OK — ex: "Python instalado, ifcopenshell funcionando"]
# O que ainda precisa ser feito
[Liste aqui os próximos passos ou o que ainda não funciona]
---
# Arquivo de regras de negócio
@regras/regras-de-negocio.md
Este arquivo é a fonte de verdade do projeto. Sempre o leia antes de iniciar qualquer tarefa.
Sempre o consulte para verificar se uma ação está alinhada com as regras definidas.
Se uma nova regra emergir durante o trabalho, sinalize ao usuário e sugira registrá-la.
## Como o arquivo funciona
- O arquivo fica em `regras/regras-de-negocio.md`
- Crie a pasta `regras/` na raiz do projeto se ela ainda não existir
- O **usuário** descreve as regras em linguagem natural — o que o sistema deve fazer, quais são as restrições, o que nunca deve acontecer, casos especiais
- O **modelo** complementa cada regra com o lastro técnico: qual função, arquivo ou trecho de código implementa aquela regra
- Formato de cada regra no arquivo:
```
### RN-001 — [Nome curto da regra]
**Descrição (usuário):** [O que essa regra significa em linguagem simples]
**Implementação (modelo):** [Arquivo/função/lógica que implementa essa regra]
**Status:** [ ] pendente | [x] implementado | [!] atenção
```
- Numere as regras sequencialmente (RN-001, RN-002...)
- Nunca delete uma regra — apenas marque como obsoleta se não for mais válida
- Se uma ação que você for executar contradiz uma regra existente, **pare e avise o usuário antes de prosseguir**
---
# Pipeline de execução do agente
Para qualquer tarefa solicitada, siga obrigatoriamente este pipeline. Não pule etapas.
## Etapa 1 — Plano
- Antes de fazer qualquer coisa, escreva um plano claro com:
- O que você entendeu que precisa ser feito
- Quais arquivos serão criados ou modificados
- Qual a sequência de passos
- Riscos identificados
- **Salve o plano como `plans/plano-YYYYMMDD-descricao-curta.md`** — crie a pasta `plans/` na raiz do projeto se ainda não existir
- Formato sugerido:
```
📋 PLANO
Tarefa: ...
Arquivos afetados: ...
Passos:
1. ...
2. ...
Riscos: ...
```
## Etapa 2 — Validação com o usuário
- Apresente o plano e pergunte: "Este plano está correto? Posso prosseguir?"
- **Não execute nada antes da confirmação**
- Se o usuário corrigir algo, revise o plano e peça confirmação novamente
## Etapa 3 — Execução
- Execute exatamente o que foi aprovado no plano
- A cada passo concluído, informe brevemente: "✅ Passo X concluído: [o que foi feito]"
- Se algo inesperado acontecer durante a execução, **pare e informe o usuário**
## Etapa 4 — Testes
- Após a execução, rode ou sugira testes básicos para verificar se o resultado está correto
- Para scripts Python: execute com um arquivo de exemplo e mostre o resultado
- Para automações: verifique se a saída esperada foi gerada
- Mostre o resultado dos testes ao usuário antes de declarar a tarefa concluída
## Etapa 5 — Checks básicos
- Verifique se:
- [ ] Nenhum arquivo foi modificado fora do escopo aprovado
- [ ] As regras de negócio em `regras/regras-de-negocio.md` foram respeitadas
- [ ] Nenhum dado sensível foi exposto (senhas, tokens, chaves de API)
- [ ] O código está legível e com comentários básicos em português
- [ ] A tarefa resolveu o que o usuário pediu (confirme com ele)
- Informe o resultado: "✅ Checks concluídos" ou "⚠️ Encontrei o seguinte ponto de atenção: ..."